Skip to main content

5.3.1 提款反向验签

#简要描述: 在用户发起提款请求时,商户平台会生成一份签名数据(如交易订单),发送至后台 处理。为了确保数据未被篡改、请求来源合法可信,后台需对请求内容进行“反向验签”操作。

反向验签设置:商户需登陆商户后台自行设置 (登陆信息请向运营人员获取)如下图:

img

步骤说明

1、商户登陆后台
2、点击导航栏里商户管理
3、点击商户设置
4、点击开启 API 开关,输入自定义请求 url 和密钥,保存即可

请求说明
  • 请求方式: POST
  • 请求接口: 商户提供
  • 请求媒体类型( JSON 数据格式 )Content-Type: application/json

注: 若商户未开启 API 安全,则无需处理此业务。(必看)

请求参数
参数名称类型必填参数含义参数说明
keystring商户 key平台分配商户 key
localOrderIdstring商户平台本地订单号商户平台本地生成唯一订单号
localUserIdstring商户平台本地用户 ID商户平台本地用户 ID
amountnumber订单金额提款金额
networkstring主网主网(目前仅支持 TRON、BSC、POLYGON、ETHEREUM)
addressstring提款地址提款地址
notifyUrlstring回调地址下单成功后,由 API 回调通知商户的地址 | (回调详情参照文档 3)
noncestring随机字符串随机字符串
currencystring币种币种(钱包支持数字币种)
successRedirectUrlstring地址成功后自动跳转地址
isBlockchainboolean是否返回区块链信息(默认 false)当为 true 时,回调请求会携带订单链上交易信息
请求 json 样例
{
"amount": 30,
"isBlockchain": true,
"address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
"merchantId": 303675535978,
"notifyUrl": "http://conan.test/notify",
"currency": "USDT",
"localOrderId": "CONAN-9999",
"merchantCurrency": "USDT",
"nonce": "MapDwK",
"key": "dNNTJZpgFVWlYrVv",
"network": "TRON"
}

注: 系统请求(商户反向验签路径)参数是与商户提款请求参数是一致的。(必看)

响应示例
 "2b703624f24962f5a12d5d1f7569447a"

响应结果说明: 响应加密后的字符串,即把请求参数与商户自定义的反向验签密钥,进行加密处理生成的加密字符串(加密算法请参考 2 如何签名)。(必看)